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Controller Library (libpad) 


1.1 Overview 


libpad is the controller library for the PlayStation 2. The current 
version is compatible with the following PlayStation controllers: 
(1) Digital controller (ID = 4) : 
(2) DUALSHOCK (ID = 7) 
(3) NeGcon (ID = 2) 
(4) Analog joystick (ID = 5) 


In the future, the system will be compatible with almost all 
PlayStation controllers. Additional compatible controllers will 
be added over time. 


The main functions of the library are as follows: 
(1) Get button data 
(2) Change controller mode 
(3) Control actuator (vibrate) 


1.2 Configuration 
libpad consists of an IOP module and an EE library. The IOP 
module is loaded and initialized by the IOP kernel during 
boot-up. Nothing needs to be set by the application. 


The EE library is linked to an application program before use. 
The link file is libpad.a, and the include file is libpad.h. 


1.3 IOP Module 
The module for the controller library is padman.irx. This module 
is needed when using the controller library so execute LoadModule 
from an EE-side program. 

1.4 EE Library 
When using the library, it is necessary to specify the library in 
each Makefile. This can be done by appending -lpad to the link 
options. 

1.5 Notes 
(1) The operation of libpad has been verified by means of the 
T-10000 development tool. It will not run on other development 
systems (e.g., EB-2000). 
(2) libpad cannot coexist with the pad/pads drivers used in 

. sceOpen() that is provided by the fileio.irx module, so the 

pad/pads drivers should not be used. 


However, if it is necessary to use these drivers, make sure that 
padman.irx is not loaded. 


1.6 Library Operation 


The controller library runs mainly on the IOP. Communication with 
the controller is performed automatically by the padman.irx module 
on the IOP, once per frame by means of the VBlank interrupt. The 
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communication results are sent sequentially to the EE's RDRAM, 
using DMA. The data sent during a DMA transfer can be obtained 
using the scePadRead() function. 


In the future, this function will be extended such that controller 
communication timing can be freely set from an application. 
However, an interval of at least one frame will be required when 
communicating with the same controller. 


About DUALSHOCK 2 


The DUALSHOCK 2 controller is equivalent to the PlayStation's 
DUALSHOCK controller except for the addition of pressure-sensitive 
functions. When not in pressure-sensitive mode, it is compatible 
with the DUALSHOCK. 


To use the pressure-sensitive functions of the DUALSHOCK2, you 
must use the following procedure to switch to pressure-sensitive 
mode. 


(1) Switch to analog mode by using the same procedure that is 
used for the DUALSHOCK controller. 

(2) Use scePadInfoPressMode() to confirm that the controller is 
really a DUALSHOCK 2. 

(3) Use scePadEnterPressMode() to switch to pressure-sensitive 
mode. To exit pressure-sensitive mode, use 
scePadExitPressMode(). 


In pressure-sensitive mode, the DUALSHOCK2 has the same functions 
as the DUALSHOCK except that the data length is increased. The 
controller mode ID is still 7. ; 


In pressure-sensitive mode, when the controller's ANALOG button is 
pressed (if it has not been locked), the controller switches to 
digital mode. Note that when the button is pressed again, the 
controller switches to the DUALSHOCK's analog mode, not to 
pressure-sensitive mode. To switch to pressure-sensitive mode, 

you must call scePadEnterPressMode() again. 


The pressure-sensitive level is represented by an 8-bit value for 
each button. The harder the button is pressed, the larger the 
numeric value. Since 0 represents the state in which the button 
is not pressed, there are 255 levels from 1 to 255 to represent 
the strength of pressure on the button. 


About the multi tap 

The multi tap library must be used when using the multi tap for 
PlayStation 2. Refer to the multi tap library documentation for 
details. é 


Description of EE Library Functions 


The following functions are provided in the EE library libpad: 


$o----------e -- po------------ eee + 
Name Function 

scePadEnd Terminate controller library 

scePadEnterPressMode Set controller to pressure-sensitive mode 


scePadExitPressMode Exit from pressure-sensitive mode 
scePadGetReqState Get execution result of asynchronous 


function 

scePadGetSlotMax Get the maximum number of controller port 
slots 

scePadGetState Get controller connection state 

scePadinfoAct Get actuator information 


scePadinfoComb Get information about combination of 


actuators that can operate simultaneously 
scePadInfoMode Get information related to the controller 
mode 
scePadiInfoPressMode Get information about whether the 
connected controller supports 
pressure-sensitive functions 


scePadinit Initialize controller library 
scePadPortClose Stop communication with the controller 
scePadPortOpen Start communication with the controller 
scePadRead Get button data 


scePadReqintToStr Get character string corresponding to 
execution result of asynchronous function 
(for debugging) 

scePadSetActAlign Set breakdown of actuator parameters to 
be sent to controller 

scePadSetActDirect Send actuator parameters to controller 

scePadSetMainMode Switch controller mode/lock mode switch 

scePadStateIntToStr Get character string corresponding to 
controller state (for debugging) 


Terminate controller library 
[Syntax] 
int scePadEnd( void ) 


[Arguments] 
None 


{Return Value] 
1: Success 
Other than 1: Failure 


[Description] 
Terminates the controller library. 


Terminates all threads that had been running in the IOP and 
releases resources. 


[See Also] 
scePadinit () 
scePadEnterPressMode [Function] 
Set controller to pressure-sensitive mode 
[Syntax] 
int scePadEnterPressMode ( 
int port, 
int slot 
) 
[Arguments] 
port Controller port number 
slot slot number (fixed at 0, except when using a multi tap) 


{Return Value] 
1: Request was accepted 
Other than 1: Request was not accepted 


[Description] 
Sets the controller of the specified port to pressure-sensitive 
mode.Actually, to switch the controller to pressure-sensitive mode 
requires several frames, and the switch is performed 
asynchronously. 


Determine when processing ends either by using scePadGetState() to 
monitor the controller connection state or by using 
scePadGetReqState() 

to get the execution result of the request. 


When the controller enters pressure-sensitive mode, the controller 
ID changes to 0x79. 


[See Also] 
scePadExitPressMode () 


Exit from pressure-sensitive mode 
[Syntax] 
int scePadExitPressMode ( 
int port, 
int slot 


) 


{Arguments } 
port Controller port number 
slot slot number (fixed at 0, except when using a multi tap) 


{Return Value] 
1: Request was accepted 
Other than 1: Request was not accepted 


[Description] 
Causes the controller of the specified port, which is already in 
pressure-sensitive mode, to exit from pressure-sensitive mode. 


Actually, several frames are required for the controller to exit 
from pressure-sensitive mode, and the mode switch is performed 
asynchronously. 


Determine when processing ends either by using scePadGetState() to 
monitor the controller connection state or by using 
scePadGetReqState() to get the execution result of the request. 


When the controller exits from pressure-sensitive mode, the 
controller ID returns to 0x73. 


[See Also] 
scePadEnterPressMode () 


Get execution result of asynchronous function 
[Syntax] 
int scePadGetReqState ( 
int port, 
int slot 
) 


(Arguments ] 
port Controller number 
slot slot number (fixed at 0, except when using a multi tap) 


{Return Value] 


+---------------------- +-------------------~--------- + 

Return value Description 

scePadRegStateBusy Executing 

scePadReqStateFaild Processing failed for some reason 


scePadReqStateComplete The function terminated normally 
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[Description] 
This function is used after an asynchronous function was executed 
to check whether or not processing was successful. An asynchronous 
function is one that terminates immediately but requires several 
frames to communicate with the controller on the IOP. The 
following functions are asynchronous functions: 


scePadSetMainMode () 
scePadSetActAlign() 
scePadEnterPressMode () 
scePadExitPressMode () 


{See Also] 
scePadSetMainMode(), scePadSetActAlign(), scePadEnterPressMode(), 
scePadExitPressMode () 


Get maximum number of controller port slots 


[Syntax] 
void scePadGetSlotMax ( 
int port 
) 


[Arguments] 
port controller port number (0 or 1) 


{Return value] 
Returns the maximum number of slots for the multi taps connected 
to the specified controller ports. 


[Description] 
scePadGetSlotMax checks the maximum number of slots on the 


multi tap connected to the port which was opened using sceMtapPortOpen(). 


When the multi tap is not connected, 1 is returned. If the multi tap is 


connected, but the port was not opened using sceMtapPortOpen(), 1 is 
returned. 
scePadGetState ([Function] 


Get controller connection state 
(Syntax] 
int scePadGetState ( 
int port, 
int slot 


) 


[Arguments] 
port Controller port number 
slot slot number (fixed at 0, except when using a multi tap) 


(Return Value] 
Controller connection state 


Return value Description 

scePadStateDiscon Controller is not connected 

scePadStateFindPad Controller was not found (processing 
continues) 

scePadStateFindCTP1 CTP1.0 controller was detected 

scePadStateExecCmd Communication with controller in progress 

scePadStateStable CTP2.0 controller was detected 

scePadStateError Communication error 
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Among the states listed above, scePadStateFindCTP1 and 
scePadStateStable are the only ones in which a request from an 
application can be accepted or the button state can be obtained. 


[Description] 
Gets the connection state of the controller on the opened port. 
When a port is opened, the IOP's padman.irx module independently 
monitors the connection and gets information for the connected 
controller. 


Also, multiple communications are required to change the controller 
state, and an interval of several frames is required until this is 
completed. 


During this interval, button states cannot be obtained and requests 
from applications cannot be accepted. An application can use 
scePadGetState() to check the state of padman.irx processing. If 
the scePadGetState() return value is scePadStateStable or 
scePadStateFindCTP1, button information can be obtained from the 
controller. 


Get actuator information 


(Syntax] 
int scePadInfoAct ( 
int port, 
int slot, 
int actno, 
int term 


) 


[Arguments] 
port Controller port number 
slot slot number (fixed at 0, except when using a multi tap) 
actno Actuator number (0 to (total number of actuators - 1); 
-1: Causes function to return the total number of 
actuators) 
term Term (return value reference; meaningless when actno=-1) 


{Return value] 
The relationship between the term argument and the return 
value is as follows: 


term Return value 
InfoActFunc Function number (1: Continuous rotation vibration) 
InfoActSub Subfunction number (1: Low-speed rotation; 

2: High-speed rotation) 


InfoActSize Parameter data length (0: 1 bit (ON/OFF only); 
1 or greater: Number of bytes) 
InfoActCurr Current consumption capacity (10mA units) 
toon coe e enn $--------------+-+----------------- ~~ + - + - -------- + 
In addition, if actno = -1, the return value contains the total 


number of actuators. In this case, the term argument is ignored. 


[Description] 
Gets detailed information regarding actuators installed in the 
controller. When actno = -1, it also obtains the total number of 
actuators. 


This function is valid only when the return value of 
scePadGetState() is scePadStateStable. 


scePadInfoComb [Function] 


Get information about combination of actuators that can operate 
simultaneously 


[Syntax] 
int scePadInfoComb ( 
int port, 
int slot, 
int listno, 
int offs 
) 


{Arguments ] 
port Controller port number 
slot slot number (fixed at 0, except when using a multi tap) 
listno List number of combination list (0 to (total number of 
combination lists - 1); 
-1: Causes function to return the total number of 
combination lists) 
offs Offset within combination list (0 to (total number of 
actuators contained in list) - 1; 
-1: Causes function to return the total number of 
actuators in the list) 


{Return Value] 


+-------- +-------- +------------------------------------------ + 
listno offs Return value 
~-1 x Total number of combination lists 
(n) 
0 to n-1 -1 Total number of actuators contained 
in list (m) 
0 to n-1 0 to m-1 Actuator number stored in offset 


position offs of list having list 
number listno 


[Description] 
Gets the combination of actuators that can operate simultaneously, 
which is restricted due to factors such as the physical arrangement 
of actuators. 


Get information related to the controller mode 


[Syntax] 
int scePadInfoMode ( 
int port, 
int slot, 
int term, 
int offs 
) 
{Arguments ] 
port Controller port number 
slot slot number (fixed at 0, except when using a multi tap) 
term Item to be checked 
offs Offset in controller mode ID table that contains the 


controller mode ID to be checked 


{Return value] 
The return value for the various values of term is as follows: 


term offs Return value 
InfoModeCurID -1 Currently operating controller mode ID 
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Valid no. of digits: 4 bits (same as the value of 
the button information's terminal type) 


InfoModeCurExID x Mode ID of the currently operating controller for 
controllers with a vibration function 
Valid no. of digits: 16 bits (0 for SCPH-1150 or 
vibration function incompatibility) 


InfoModeCurExOffs x Offset in table which contains the currently 
operating controller mode ID 
(0 for SCPH-1150 or vibration function 
incompatibility) 


InfoModeIdTable -1 Total number of controller mode IDs (n) 


InfoModelIdTable O~n-1 Controller mode ID stored at offset specified by 
offs, in the controller mode ID table 
(0 for SCPH-1150 or vibration function 
incompatibility) 


[Description] 
Allows the currently operating controller mode ID to be checked, 
controllers that are compatible or incompatible with the vibration 
function to be identified, and determines the controller mode ID of 
controllers with the vibration function. (The SCPH-1150 controller 
does not have a vibration function and is handled as an exception.) 


Determine whether the connected controller supports 
pressure-sensitive functions 


[Syntax] 
int scePadInfoPressMode ( 
int port, 
int slot 
} 


[Arguments] 
port Controller port number 
slot slot number (fixed at 0, except when using a multi tap) 


{Return Value] 
1: Pressure-sensitive functions supported 
Other than 1: Pressure-sensitive functions not supported 


[Description] 
Determines whether the controller connected to the specified 
port supports pressure-sensitive functions. 


Initialize libpad controller library 


[Syntax] 
int scePadInit ( 
int mode 


) 


[Arguments] 
mode Initialization mode (currently fixed at 0.) 


{Return value] 
1: Terminated normally 
Other than 1: Initialization failure 
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[Description] 
Initializes the libpad controller library. 


[See also} 
scePadEnd() 


Stop communication with the controller 
[Syntax] 
int scePadPortClose( 
int port, 
int slot, 


) 


[Arguments] 
port Controller port number 
slot slot number (fixed at 0, except when using a multi tap) 


{Return Value] 
1: Success 
Other than 1: Failure 


[Description] 
Closes the port that was opened with scePadPortOpen(). 
Subsequently, communication with the closed port is terminated. 


[See Also] 
scePadPortOpen () 
scePadPortOpen [Function] 
Begin communication with the controller 
(Syntax] 
int scePadPortOpen ( 
int port, 
int slot, 


u_long128* data 
) 


[Arguments ] 
port Controller port number (0 or 1) 
slot slot number (fixed at 0, except when using a multi tap) 
data Work buffer (The required size is defined by the constant 
PadDmaBufferMax. ) 


[Return value] 


1: Request received. 
Other than 1: Request not received. 
[Description] 


Opens the specified controller port. 


When the controller port is opened, padman.irx monitors the 
controller connection. After the connection is made, the 
controller information is automatically obtained. 


Button information can also be obtained. Once the controller 

port is open, a latency of several frames is needed before button 
information becomes available. Monitor scePadGetState() to 
determine whether or not button information is available. 


Get button information 
(Syntax] 
int scePadRead ( 
int port, 
int slot, 
unsigned char* data 


) 


(Arguments] 
port Controller port number (0 or 1) 
slot slot number (fixed at 0, except when using a multi tap) 
data Pointer to buffer in which button information is stored. 


Buffer must be 32 bytes. 


[Return value] ; 
0: Failed to get information. 
Other than 0: Length of obtained data (currently fixed at 32) 


[Description] 
Gets the latest button information sent to the EE. The button 
information is sent only for the opened port. The contents 
of the buffer are shown below: 


Digital Controller Data Array 


foo eee 4-----------------+----+------------------------ + 
Offset (bytes ontents 
ff (b ) C 
[0 Successful communication: 0, otherwise: Oxff | 
[1 High-order 4 bits: 0x4 | 
Low-order 4 bits: Data length/2 
[2,3 Digital button state (1: released, 0: pushed) | 
tooo no -------- $o---------- = = 5 5 5 5-5-5 5 = = = = 5 -- = ----- + 


DUALSHOCK Data Array 


$------------------ +------~---------------------------- + 
|O£fset (bytes) Contents | 
{0 Successful communication: 0, | 

| otherwise: Oxff 
[z High-order 4 bits: 0x7 
| Low-order 4 bits: Data length/2 | 
2,3 Digital button state | 

| (1: released, 0: pushed) 
|4 Analog stick right (X direction) | 
15 Analog stick right (Y direction) | 
16 Analog stick left (X direction) | 
\7 Analog stick left (Y direction) | 
poo +------~--~---------+---------------- + 


Analog Joystick Data Array 


$o----------------- $o--------- = ~~ = ---+ 
jOffset (bytes) Contents | 
{0 Successful communication: 0, | 

| otherwise: Oxff 
[1 High-order 4 bits: 0x5 | 
| Low-order 4 bits: Data length/2 | 
12,3 Digital button state | 

| (1: released, 0: pushed) 
[4 Analog stick right (X direction) | 
{5 Analog stick right (Y direction) | 
|6 Analog stick left (X direction) | 
|7 Analog stick left (Y direction) | 
$o---------- +------~~+-~--~--------------------- + 


NeGcon Data Array 


$o-- 2-5-2 ---------- $---+------------------------------ + 
|Offset (bytes) Contents | 
}0 Successful communication: 0, | 
| otherwise: Oxff | 
|1 High-order 4 bits: 0x2 | 


| Low-order 4 bits: Data length/2 | 


\2.3 Digital button state | 
| (1: released, 0: pushed) | 
[4 Rotary part's analog data | 
[5 I button analog data | 
|6 II button analog data | 
|7 L button analog data | 
t—-----+~----------- +---------------------------~------ + 
DUALSHOCK 2 Data array (in pressure sensitive mode) 
+-----------~------ $------------------------------------ + 
|Offset (bytes) Contents | 
|0 Successful communication: 0, | 
| otherwise: Oxff | 
{1 High-order 4 bits: 0x7 | 
| Low-order 4 bits: Data length/2 | 
[2,3 Digital button state | 
| (1: released, 0: pushed) | 
[4 Analog stick right (X direction) | 
[5 Analog stick right (Y direction) | 
|6 Analog stick left (X direction) | 
17 Analog stick left (Y direction) | 
[8 Pressure sensitivity information(>) | 
|9 Pressure sensitivity information(<) | 
[10 Pressure sensitivity information(*) | 
[11 Pressure sensitivity information(vV) | 
[12 Pressure sensitivity information(Tr) | 
[13 Pressure sensitivity information(O) | 
{14 Pressure sensitivity information(xX) | 
{15 Pressure sensitivity information(Sq) | 
[16 Pressure sensitivity information(L1) | 
[17 Pressure sensitivity information(R1) | 
[18 Pressure sensitivity information(L2) | 
[19 Pressure sensitivity information(R2) | 
$------------------ $------------------------------------ + 
Note: 
> = right-arrow key 
< = left-arrow key 
“ = up-arrow key 
V = down~arrow key 
Tr = Triangle button 
O = Circle button 
X = X button 
Sq = Square button 
Button State Bit Assignments (Offset 2) 
+----------+-~------------- +--+--+--+--4+--4~--4+--4+---4+ 
{Bit offset 7 6 5 4 3 2 1 =0 
[Digital controller < V > * ST SEL | 
| DualShock < V > * ST R3 L3 SEL| 
[Analog joystick < V > * Sst SEL | 
|NeGcon < V > * sf | 
+------------------------ +--t+--+--4--4--4--+--4---4 
Note: 
< = left-arrow key 
> = right-arrow key 
V = down-arrow key 
“ = up-arrow key 
Button State Bit Assignments (Offset 3) 
$o------ == + foto -t--t--$--4--4--4--4+ 


[Bit offset 
[Digital controller 
| DualShock 

[Analog joystick 
|NeGcon 


4+-o----- EE 


4 3 2 


1; 20: || 
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O Tr R1 L1 R2 L2| 
O Tr R1 L1 R2 L2| 
O Tr Rl L1 R2 L2| 
A BR | 


mar t+--t--+-- t+ -- tt t+ 


Note: 
Sq = Square button 
X = X button 
QO = Circle button 
Tr = Triangle button 


Get character string corresponding to execution result of 
asynchronous function (for debugging) 


(Syntax] 
void scePadReqiIntToStr ( 
int state, 
unsigned char* str 


) 


{Arguments ] 
state Execution result code 
str Pointer to buffer used for storing character string 
(required size is max. 16 bytes) 


{Return Value] 
None 


[Description] 
Converts the execution/result code of an asynchronous function 
obtained using scePadGetReqgState() to a character string. 


scePadSetActAlign [Function] 
Send details of actuator parameters to the controller 
[Syntax] 
int scePadSetActAlign ( 
int port, 
int slot, 


unsigned char* data 


) 


[Arguments] 
port Controller port number 
slot slot number (fixed at 0, except when using a multi tap) 
data Sent details of actuator parameters (6 bytes) 


{Return value] 
1: Request received. 
Other than 1: Request not received. 


[Description] 
Notifies the controller of the locations where the actuator 


parameters are stored in the send buffer, by writing the actuator 
numbers in a 6-byte array. 


In the following example, send buffer offset 0 is used as actuator 
no. 0, offset 1 is used as actuator no. 1, and other data are not 
used. (The actuator numbers are stored in valid locations, and 
unused locations are set to Oxff.) 


Offset: 0 1 2 3 4 5 
Data contents: 0x00 0x01 OxFF OxFF OxFF OxFF 


Since communication with the controller is carried out when this 


function is executed, other requests cannot be received for several 
frames. 


Completion of processing can be monitored using scePadGetState() 
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or by checking the scePadGetRegState() result. 

Details of the actuator parameters set by this function become 
ineffective if the controller is disconnected or the controller 
mode is changed. 


Send actuator parameters to the controller 
[Syntax] 
int scePadSetActDirect ( 
int port, 
int slot, 
unsigned char* data 


) 


(Arguments ] 
port Controller port number 
slot slot number (fixed at 0, except when using a multi tap) 
data Starting address of transmit data 


6 bytes of transmit data should be provided 


[Return value] 
1: Successful transmission 
Other than 1: Failure 


[Description] 
Sends the transmit data to the IOP for operating an actuator. The 
transmitted data is sent to the controller at the next VBlank 
interrupt. 
Before executing this function, details of the actuator parameters 
must be set first in scePadSetActAlign(). 


Change controller mode / lock changeover switch 

[Syntax] 

int scePadSetMainMode ( 

int port, 

int slot, 

int offs, 

int lock 
) 


[Arguments ] 
port Controller port number 
slot slot number (fixed at 0, except when using a multi tap) 
offs Offset in controller mode ID table containing the switched 
controller mode 
lock 
0, 2: Maintain current locked or unlocked state of 
changeover switch 
1: Unlock changeover switch 
3: Lock changeover switch 


{Return value] 
1: Request received 
Other than 1: Request not received. 


[Description] 
Switches controller modes, and switches between the locked and 
unlocked states of the mode switch button on the controller's 
main unit. 


When this function is executed, other requests cannot be 
received immediately, and controller button information will 
not be available for several frames. The completion of processing 
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should be checked using scePadGetState() or the result of 
scePadGetReqState(). 


In addition, when the controller mode is switched, previously 
set actuator settings become invalid. 


Get character string corresponding to controller state 
(for debugging) 


(Syntax] 
void scePadStateIntToStr ( 
int state, 
unsigned char* str 


) 


{Arguments ] 
state State code 
str Pointer to buffer used for storing the string (required size is 


{Return Value] 
None 


[Description] 


Converts the controller state code obtained using scePadGetState() 
to a character string. 


